home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / phelp / calc.txt < prev   
Encoding:
Text File  |  1991-11-04  |  11.6 KB  |  271 lines
  1.  
  2. ******************************************************************
  3. *                                                                *
  4. *                         Programer's Help                       *
  5. *        Das 1001 Multi-Accsessory für die Atari ST Reihe        *
  6. *                     (c) 1991 by Richard Kurz                   *
  7. *                        Vogelherdbogen 62                       *
  8. *                          7992 Tettnang                         *
  9. *                       Telefon 07542/52908                      *
  10. *                                                                *
  11. *               TOS-Magazin, ICP Verlag GmbH & Co. KG            *
  12. *                                                                *
  13. ******************************************************************
  14.  
  15. Willkommen zu dem 1001 Multi-Accessory für den ST, STE, Mega-STE 
  16. und wahrscheinlich auch TT. Da ich leider keinen TT besitze und 
  17. auch keinen Besitzer eines solchen kenne, war es mir nicht möglich 
  18. Programmer's Help auf dem Sahneschnittchen zu testen. Da ich mich 
  19. aber an alle bekannten Richtlinien von Atari gehalten habe (man 
  20. merkt es auf dem kleinen ST am Bildschirmaufbau.. gähn), sollte 
  21. es auch auf dem TT oder diversen Beschleunigerkarten sowie auch 
  22. auf Großbildschirmen laufen. Die einzige Hardwarevoraussetzung ist
  23. eine Bildschirmauflösung von mindestens 640*200 Punkten, will 
  24. heißen: Ab der mittleren ST-Auflösung läuft es prächtig. Der 
  25. Speicherverbrauch liegt bei cirka 100 Kb.
  26.  
  27. Was soll nun Programmer's Help ???
  28. Tja, ich war einmal auf der Suche nach einem Taschenrechner, der 
  29. sollte als Accessory auf dem ST laufen und er sollte einen 
  30. Ausdruck wie 12+sin(1)*pi schlucken und berechnen können. Ergebnis:
  31. NULL. Also Ärmel raufgekrämpelt, Ehefrau mit faulen Ausreden 
  32. beruhigt, an die Kiste gehechtet und selbst geschrieben. Leider 
  33. verfiel ich dem Programmierer-Wahnsinn und so wurde aus dem Rechner
  34. ein Multi-Accessory mit folgendem Leistungsumfang:
  35.  
  36. Rechner mit doppelter Genauigkeit, BASIC-ähnlichem Formelparser, 
  37. 12 Variablen, und vielen Funktionen wie: sin, sinh, asin, exp, log,
  38. sqr, and, or, shl, usw.
  39.  
  40. ASCII-Tabelle mit Übernahme eines Zeichens in das aktuelle Programm,
  41. wahlweise über Hotkey.
  42.  
  43. Notizblock mit 26 Seiten a 12 Zeilen, Suchfunktion, auch als kleine 
  44. Kartei zu verwenden.
  45.  
  46. Wecker mit 5 Alarmzeiten und Alarmwiederholung (stündlich, täglich, 
  47. monatlich oder jährlich).
  48.  
  49. Kalender von Jahre 1582 bis ins Jahr 3000. 
  50.  
  51. Programmer's Help (PH) Version 1.2  wurde mit Turbo C 2.0 erstellt.
  52. Es kann entweder als Accessory oder als Programm gestartet werden 
  53. (einfach die Endung ACC in PRG ändern). Am sinnvollsten scheint mir
  54. der Start als ACC, also einfach CALC.ACC auf die Startdiskette bzw.
  55. Festplatte kopieren und neu starten. 
  56.  
  57. In der Menü-Leiste kann es nun unter Calculator aufgerufen werden.
  58.  
  59. Durch anklicken von EXIT kommt man immer eine Ebene zurück.
  60. Mit dem Closer oder der Taste UNDO wird das Programm verlassen.
  61. HELP       oder die gleichnamige Taste zeigen zwei kleine Hilfstexte.
  62. ASCII      Stellt eine ASCII-Tabelle zur Verfügung.
  63. NOTIZEN    Ein kleiner Notizblock.
  64. Die Bimmel 5 einstellbare Weckzeiten.
  65. KALENDER   Wie der Name schon spricht.
  66.  
  67. Die genauen Anleitungen zu den einzelnen Programmteilen gibt es auf 
  68. den folgenden Seiten. Viel Vergnügen!
  69. Ich freue mich über jede Kritik und auch Verbesserungswünsche 
  70. interessieren mich. Also munter eure Meinung kund getan!
  71.  
  72. Der Rechner:
  73. ------------
  74. Ich bilde mir zumindest ein, es handelt sich hierbei um ein leistungs-
  75. fähiges Exemplar seiner Gattung (Eigenlob müffel müffel).
  76.  
  77. Die Eingabezeile wird ähnlich wie bei einem BASIC-Interpreter 
  78. ausgewertet. Es werden beinahe beliebig komplexe Ausdrücke geschluckt,
  79. wie z.B.: - 21*&hff+((sin(0.8)+1)*2)
  80. Selbstmurmelnd werden Punkt vor Strich und Klammersetzung korrekt 
  81. berücksichtigt.
  82.  
  83. Die Eingabezeile kann wie unter GEM üblich bearbeitet werden, sie 
  84. wird mit der Taste RETURN bzw. ENTER abgeschlossen. Die letzten neun 
  85. Eingabezeilen werden gespeichert. Durch anklicken der Pfeile neben 
  86. ENTER und BACKSPACE, wahlweise mit den Cursor-Tasten (UP, DOWN)
  87. können diese wieder aufgerufen werden.
  88.  
  89. Es stehen 10 Variablen Namens M0-M9 zur Verfügung. Diesen Variablen 
  90. können durch eine Zuweisung wie M0=12+1 gesetzt werden. Bei der 
  91. späteren Verwendung wird einfach der Name der gewünschten Variable 
  92. eingesetzt.
  93. Ferner stehen noch die Variablen X und Y zur Verfügung. Sie enthalten
  94. jeweils die letzten beiden Ergebnisse.
  95.  
  96. Im Ergebnisfenster zeigen die obersten drei Zeilen das letzte Ergebnis 
  97. in den Zahlensystemen Binär, Hexadezimal und Oktal an. Die nächsten 
  98. sieben Zeilen zeigen die Ergebnisse wie ein Papierstreifen.
  99. Durch Anklicken einer Zahl im Ergebnisfenster, wird diese in die 
  100. Eingabezeile übernommen.
  101.  
  102. Zahlen können durch Vorsatz von &h, &o, &b und &d in ihrem Zahlensystem 
  103. eingegeben werden. z.B.: &hFF würde 255 im Dezimalsystem ergeben. 
  104. Auch kann über die Buttons DEZ, HEX, OCT und BIN die Eingabezeile,
  105. direkt in das jeweilige Zahlensystem geschaltet werden.
  106.  
  107. Der Button X <=> Y vertauscht die beiden Variablen.
  108.  
  109. Mit ACL wird der Rechner neu gestartet, alle Variablen werden auf 
  110. Null gesetzt.
  111.  
  112. CL löscht nur die Eingabezeile. In den meisten GEM-Versionen kann 
  113. dies auch durch drücken der ESC-Taste erreicht werden. 
  114.  
  115. Der Button M0 - M9 führt zur Bearbeitung der Variablen. Dieser 
  116. Programmteil wird unter Variablen ausführlich erklärt. 
  117.  
  118. Folgende Rechenarten und Funktionen stehen zur Verfügung:
  119.  
  120. Funktion      Erklärung          Beispiel           Ergebnis
  121. +             Plus               1+1                2
  122. -             Minus
  123. *             Mal
  124. /             Geteilt
  125. mod           Modulo             7 mod 2            1
  126. ^             Potenz             5^3                125
  127.  
  128. shl           32 Bit nach links  1 shl 4            16
  129. shr           32 Bit nach rechts schieben 
  130. and           Und                7 and 2            2
  131. or            Oder
  132. xor           Exklusiv Oder
  133. not           Bitweise Negation  not 7              -8
  134.  
  135. &h            Hexadezimal-Zahl   &hff               255
  136. &o            Oktal-Zahl         &o10               8
  137. &b            Binär-Zahl         &b111              7
  138. &d            Dezimal-Zahl       &d300              300
  139.  
  140. pi            Pi                 pi                 3.14159....
  141. e             Eulersche Zahl
  142.  
  143. abs           Absolut-Wert       abs(-1)            1
  144. acos          Arcus Cosinus
  145. asin          Arcus Sinus
  146. atan          Arcus Tangens
  147. cosh          Cosinus hyperbolicus
  148. cos           Cosinus
  149. exp           Exponentialfunktion
  150. log10         Dekadischer Logarithmus
  151. log           Natürlicher Logarithmus
  152. pow10         10er-Potenz
  153. round         Runden             round(1.6)         2
  154. sinh          Sinus hyperbolicus
  155. sin           Sinus
  156. sqrt          Quadratwurzel
  157. sqr           Quadrat
  158. tanh          Tangens hypebolicus
  159. tan           Tangens
  160. trunc         Abschneiden der    trunc(1.6)         1
  161.               Nachkommastellen
  162.  
  163. Die Variablen:
  164. --------------
  165. Um es noch einmal in Erinnerung zu bringen: Dieser Programmteil wird
  166. durch Anklicken des M0-M9 Buttons im Rechner angewählt.
  167. Hier können die Werte der Variablen angesehen, geändert und in die 
  168. Eingabezeile übernommen werden.
  169. Was das Ansehen betrifft, kann ich mir wohl die Erklärung schenken.
  170.  
  171. Durch anklicken eines Namens (z.B. M0) wird der Wert der Variablen 
  172. in die Eingabezeile übernommen (juchu).
  173.  
  174. In dem Eingabefeld hinter dem Namen, kann der neue Wert eingegeben 
  175. werden (Was für ein Satz). Es können auch beliebige Formeln wie 
  176. 12+sin(1)*2 benutzt werden (Wie im normalen Rechner).
  177.  
  178. Die ASCII-Tabelle:
  179. ------------------
  180. Dieses nette Teil stellt den Zeichensatz zur Verfügung.
  181.  
  182. Mit den < << >> > Buttons kann durchgeblättert werden.
  183.  
  184. Was nützt es mir nun wenn ich das Zeichen kenne, es aber nicht über
  185. die Tastatur eingeben kann? Nichts ätsch. Aber wir haben ja nicht 
  186. irgendeine Zeichensatztabelle, nein wir haben Programmer's Help! 
  187. ('tschuldigung das sind die Auswirkungen des modernen Werbefernsehens).
  188. Also was tun? Ganz einfach: das gewünschte Zeichen anklicken und dann
  189. entweder auf DIREKT oder SHIFT SHIFT klicken.
  190.  
  191. Wird der DIREKT Button angeklickt, schreibt BH Verzeihung PH das Zeichen 
  192. sofort in den Tastaturpuffer und beendet sich selbst.
  193.  
  194. Nun der Oberhammer: Da es auch in GEM-Programmen nicht immer möglich 
  195. ist ACC's aufzurufen, z.B. in Dialogboxen, und es mit der direkten 
  196. Übernahme auch nicht immer klappt (z.B. Calamus. Warum auch immer?), 
  197. kann das Zeichen auch über die Tastaturkombination Shift links und 
  198. Shift rechts in den Tastaturpuffer befördert werden.
  199. Wird Shift Shift angeklickt geht PH in den Hintergrund und lauert 
  200. darauf, daß beide Shift-Tasten gleichzeitig gedrückt werden.
  201. Dieser Zustand hält bis zum nächsten Aufruf über die Menüleiste an.
  202.  
  203. Der Notizblock:
  204. ---------------
  205. Er ist aufgeteilt in 26 Seiten a 12 Zeilen. Die einzelnen Seiten 
  206. können durch Anklicken eines Buchstabens (A-Z) angewählt werden. 
  207. Natürlich kann man so auch eine kleine Telefonkartei oder ähnliches 
  208. einrichten. Die einzelnen Zeilen können je nach verwendeter GEM-
  209. Version bearbeitet werden (z.B. die ESC-Taste löscht die Zeile). 
  210. Einziger Luxus: bei RETURN oder ENTER springt der Cursor in die 
  211. nächste Zeile.
  212. Nun zu den Buttons:
  213. CL            Löschen einer Seite bzw. des ganzen Notizblockes.
  214. PFEILE        Eine Seite vor bzw. zurück.
  215. LOAD          Laden des Notizblockes von Disk (ASCII-Format).
  216. SAVE          Speichern des Notizblockes auf Disk (ASCII-Format).
  217. SUCHEN        Erlaubt es nach einem Text im Notizblock zu suchen. Je 
  218.               nach gewählter Einstellung, vorwärts oder rückwärts, 
  219.               mit Unterscheidung von Groß- und Kleinbuchstaben oder
  220.               ohne.
  221.  
  222. Der Wecker:
  223. -----------
  224. Wer kennt und verflucht ihn nicht?
  225. Aber da ich alles um mich herum vergesse wenn ich an meiner Kiste 
  226. sitze, hielt ich einen Wecker für unbedingt nötig.
  227.  
  228. Dieses Exemplar stellt fünf Weckzeiten zur Verfügung. Jeder Alarm 
  229. kann entweder stündlich, täglich, monatlich oder jährlich wiederholt 
  230. werden. 
  231. Je nach eingestellter Wiederholrate werden natürlich nur die 
  232. sinnvollen Angaben von Datum und Zeit berücksichtigt (z.B. es 
  233. werden bei stündlicher Wiederholung nur die Minuten berücksichtigt).
  234.  
  235. Wenn ein Alarm aktuell ist (dies wird cirka zwei mal pro Minute 
  236. getestet) meldet sich PH mit einer Alert-Box, die den Text und die 
  237. Uhrzeit enthält.
  238.  
  239. Nun gibt es auf dem ST ja leider nicht nur GEM- sondern auch TOS- 
  240. und andere Programmarten. Solange GEM blockiert ist kann auch kein 
  241. Alarm ausgegeben werden. PH vergißt aber die Alarme nicht, sondern 
  242. meldet sich sobald GEM wieder läuft. 
  243.  
  244. Bitte dran denken: nach einem RESET oder Absturz bzw. Ein- und 
  245. Ausschalten, sind die Alarme natürlich auch futsch.
  246.  
  247. Um die Folgen derartiger Unannehmlichkeiten etwas zu mindern, sind 
  248. die Buttons LOAD bzw. SAVE gedacht. Damit können die Alarmzeiten auf 
  249. Disk gesichert bzw. von dort geladen werden.
  250.  
  251. Wer den Alarmton schon einmal vorab hören möchte, kann ja ganz 
  252. unverbindlich auf die Überschrift ALARM klicken (Klassik-Fans mögen 
  253. mir verzeihen). 
  254.  
  255. Der Kalender:
  256. -------------
  257. Mein ganzer Stolz! (Es war echt eine Freude das Ding zu basteln).
  258.  
  259. Dieser Kalender liefert gültige Daten vom Jahre 1582 bis zum Jahr 
  260. 3000. Ich hoffe das reicht!
  261. Mit den Buttons < und > wird jeweils einen Monat vor bzw. zurück-
  262. geblättert, mit << und >> jeweils ein Jahr.
  263.  
  264. Es kann auch ein beliebiges Datum in das Eingabefeld geschrieben 
  265. werden. Durch anklicken des Eingabefeldes oder RETURN bzw. ENTER 
  266. springt der Kalender dann auf dieses Datum, vorausgesetzt es war 
  267. sinnvoll.
  268.  
  269. Wird ein bestimmter Wochentag angeklickt, erscheint dieser in der 
  270. Zeile über dem Kalender.
  271.